PhoneBook Application using MySQL and PHP
Overview
This is a simple phone book web application which supports:
- New contact creation
- Existing contact deletion
- Updating any existing contact
- Responsive User Interface
Technologies Used
- Front-End: HTML, Bootstrap 4, jQuery
- Backend: MYSQL, PHP, Apache Server
Source code
Complete source code for this project is available at GitHub
User Interface Walkthrough
Landing Page
This is the landing page of my application which displays all existing contacts on the left with the Details pane on the right. The Update and Delete buttons are initially disabled.
Contact Details
Upon clicking on a particular contact, the update and delete functionality gets activated. We can also see the corresponding contact details for the clicked contact.
Update Contact
Clicking on the update button opens up a window where user can enter changed details. The changes are captured once user clicks on Save Changes button. We can add or delete phone, address or dates as required.
Contact Creation
Similarly, to create a new contact, user has to click on create contact button and choose Save Changes button to capture the new information.
Progress Bar
The yellow progress bar gives the user an idea of the size of contacts retrieved for each query.
Search Bar
The search window allows user to search with various combinations. Here we are searching by Zip code. Hence all contact in that zip code are shown. We now search for a combination of zip and area code. This returns the specific contact match both criteria. We can also search by last name if we need the results to be more specific. While searching for address, user has to input it with hyphens. This is to help us differentiate each entry as my logic is building sql queries dynamically. If there are more than one entry matching a first name, all of them are displayed. We can also search by date of birth, entered in the specified format. We can search by city and state as shown above.
How to run the project
Install MAMP/WAMP/LAMP stack
Download the free version of MAMP(macOS): https://www.mamp.info/en/downloads/, LAMP(Linux): https://bitnami.com/stack/lamp/installer or WAMP(Windows): https://www.wampserver.com/en/download-wampserver-64bits/.
Setup MySQL database
- Create database inside MySQL named ‘dbproject’.
- Execute the ‘Create.SQL’ file on the previously created database.
- Import the CSV file (contact.csv) using MySQL workbench.
PHP Back-end setup
- Copy all the PHP files and index.html file from the root of the project into the htdocs folder of Apache installation. Learn more
Front-end
- Once the above steps are completed, the website should be available at ‘localhost:80’ or ‘127.0.0.1:80’.
Please check the port of Apache during the installation
Technical details
This web application is written in PHP as back-end programming language and MySQL as the database. Bootstrap 4 is used to implement responsive UI. jQuery is used to handle the dynamic web page changes.
Backend is implemented as REST APIs. Each PHP file listens for requests on an endpoint and either serves the appropriate data or processes requested operation.
- contact_details.php API - Returns the Name, Address and Dates data for a contact in JSON format idenitified by Contact_ID.
- Data creation APIs - These are set of APIs which creates the object and inserts into respective tables.
create_address.php create_date.php create_contact.php - Data update APIs - These APIs facilitate data modification.
update_address.php update_date.php update_contact.php - Data delete APIs - These APIs delete the data associated with contacts in contraint aware manner.
delete_contact.php
- index.html - This is the main HTML page of the web application.